home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_500 / wiconify / wiconcalls.lzh / wExample3 / wExample3.doc < prev    next >
Text File  |  1991-04-19  |  2KB  |  36 lines
  1. OVERVIEW:
  2.  
  3. wExample3 shows how to use an IconPort together with some of the more
  4. advanced wIconCalls routines in order to use a SMART_REFRESH window in a
  5. way that does not use up more memory when it is iconified.  The window is
  6. actually closed when the icon is displayed and re-openned when it icon is
  7. openned.
  8.  
  9.  
  10. NOTES:
  11.  
  12. The Icon structure is used in two different contexts:  first, as an icon
  13. associated with the window.  This icon is never actually displayed, however;
  14. it is used solely as a means of attaching an IconPort to the window.  The
  15. WI_REPORTICONVERIFY flag is used so that wIconify will not actually iconify
  16. the window itself.  Instead, the program receives a message that the window
  17. wants to become iconified; the program always clears the WI_ICONIFYOK flag,
  18. which tells wIconify that it can NOT iconify the window after all.  
  19.  
  20. At this point the program attempts to create an icon on the screen where the
  21. window is open (this is the second use of the Icon structure).  If the icon
  22. is created, the window is removed, making it look as though the window were
  23. iconified in the normal fashion.  The program checks to see if the window is
  24. active, and if so, it selectes the newly-created icon.  Then it waits for a
  25. message from the icon.
  26.  
  27. When the icon reports that it is being openned (either by a double-click or
  28. through the OPEN menu), the program attempts to re-open the window (on the
  29. same screen where it was open before).  If successful, it saves the current
  30. icon data and removes the icon.  The saved data will include the position and
  31. any flags (like WI_LOCKED) so that they will be applied again the next time
  32. the window is iconified.
  33.  
  34. When the icon reports a CLOSE (or SCREENCLOSE) message, the program exits. 
  35. The exit code cleans up any icons or windows that are open.
  36.